home *** CD-ROM | disk | FTP | other *** search
/ MACD 5 / MACD 5.bin / workbench / tools / czesc_2 / magiceye / magiceye.dok < prev    next >
Text File  |  1982-07-29  |  13KB  |  229 lines
  1.         __       __
  2.         )\\     /((  Version 37.4                            __
  3.        /  \\   /  \\         39.4  __         ________      / \\     ________
  4.       /    \\ /    \\              )\\        )      \\    (   ))    )      \\
  5.      / /\   \V /\   \\            /  \\      / ___    \\    \_//    / ___    \\
  6.     / // \    // \   \\          /    \\    / //  \___//     ___   / //  \___//
  7.    / //   \  //   \   \\        / /\   \\  / // _______      ) \\ / //
  8.   / //     \//     \   \\      / /__\   \\ \ \\ \___  \\    /  // \ \\     ____
  9.  / //               \   \\    / ______   \\ \ \\    )  \\  /  //   \ \\    )  \\
  10. / // © 1995--1997 by \   \\  / //     \   \\ \ \\__/   // /  //     \ \\__/   //
  11. \_)) Christian Krapp  \___)) \_))      \___)) \_______//  \_//       \_______//
  12.       sMail:                                               ________ ___ _____
  13.   Christian Krapp                 eMail:                  / __//\ \V /// __//
  14.   Hagenmähderstr.9    krabbe@informatik.fh-augsburg.de   / _//   \  /// _//
  15. D-86391 Stadtbergen                                     / //__   / /// //__
  16.   (GERMANY)                        WWW:                 \___//  /_// \___//
  17.                 http://www.fh-augsburg.de/~krabbe/magiceye/
  18.  
  19.                             An AugustA team Release!
  20. --------------------------------------------------------------------------------
  21.  
  22. Copyright:
  23.   Dieses Programm  und alle dazugehörige Dateien (Programm-Icon) sind  Copyright
  24. 1996  bei Christian 'cr8y' Krapp! Es  darf nur  im unveränderten Zustand weiter-
  25. gegeben  werden.  Eine Gebühr, die über den üblichen  Disketten-Preis  zuzüglich
  26. einer geringen Kopiergebühr liegt, darf nicht  erhoben werden.  Desweiteren darf
  27. dieses Programm nicht ohne Genehmigung auf eine PD-Serie oder eine  CD-Rom über-
  28. nommen werden. Diese Genehmigung ist beim Autor erhältlich und wird in der Regel
  29. gegeben.
  30.  
  31.   Nur  für die  AmiNet, FreshFish, und  MeetingPearls  CD-Rom-Serien  sind keine
  32. Genehmigungen nötig.
  33.  
  34.   Dieses Programm  ist weder Public Domain noch Shareware. Es wurde als Freeware
  35. freigegeben.  Jeder der dieses Programm  benutzt sollte mir  eine Postkarte oder
  36. eMail schicken  (Schließlich würde  es mich interessieren, wieviele Leute dieses
  37. Programm benutzen).
  38.  
  39.   Für Schäden, dir durch  die Benutzung  dieses  Programmes  entstehen, kann der
  40. Autor nicht haftbar gemacht werden. 
  41.  
  42. --------------------------------------------------------------------------------
  43.  
  44. Einführung:
  45.   Nein: Dieses Programm ist kein weiteres Programm zum Berechnen von 3D Bildern.
  46. Jeder Amiga-Benutzer  dürfte inzwischen  MagicWB  (und die  zusatz  Icon-Pakete)
  47. kennen.  Auch dürften die  verschiedenen Gag-Programme  bekannt  sein,  die  ein
  48. Augenpaar auf dem Bildschirm anzeigen, das dem Mauszeiger "verfolgt". Doch eines
  49. hat mich schon immer  gestört: Diese Augen passen nicht ganz zum Rest einer auf-
  50. gepeppten Workbench, da die meisten dieser Augenprogramme mit SW-Augen arbeiten.
  51. Aus diesem  Grund  hab ich mir  die "Arbeit" gemacht  und ein farbiges Augenpaar
  52. erstellt.
  53.  
  54. --------------------------------------------------------------------------------
  55.  
  56. 10 Gründe, dieses Programm zu benutzen:
  57.  
  58.  1.) Die Augen sind Bunt ;^)
  59.  2.) Fenster wird geschlossen, wenn WB geschlossen wird (screennotify.library)
  60.  3.) Viele Parameter sind einstellbar
  61.  4.) Patch, damit sich das Augen-Fenster wie die Screentitelleiste verhält
  62.  5.) 6(!) verschiedene Effekte mit den Augen
  63.  6.) Paßt sich an Farbpalette an MagicWB wird nicht mehr benötigt (AmigaOS 3.0+)
  64.  7.) Sehr kurzes Programm
  65.  8.) Es ist ein Commodity
  66.  9.) Bildschirm-Hintergrund kann in MagicEYE-Fenster kopiert werden
  67. 10.) MagicEYE-Fenster ist immer das hinterste Fenster
  68.  
  69. --------------------------------------------------------------------------------
  70.  
  71. Was wird benötigt?
  72.   Auf jeden  Fall braucht  man einen  Amiga-Computer  (oder kompatibel ;^) ) mit
  73. mindestens AmigaOS  2.04 oder höher. Leider  kann ich nicht garantieren, daß die
  74. Programmversion  für AmigaOS 2.04  funktioniert, da  ich nur  einen  Rechner mit
  75. AmigaOS 3.0  besitze. Desweiteren sollte  die Workbench mit mindestens  8 Farben
  76. und einer  möglichst quadratischen-Auflösung  (z.B. 640×512)  betrieben  werden.
  77. Auch  sollte  möglichst  für  die   Bildschirmtitelleiste  ein  Zeichensatz  mit
  78. mindestens der  Größe 13 benutzt werden,  da ansonsten die Augen über die Titel-
  79. leiste  hinausstehen. Um das Fenster  beim schliessen der WB  auch zu schließen,
  80. wird noch die  ScreenNotify-Library von Stefan  Becker benötigt. Ist diese nicht
  81. installiert, wird das Fenster nicht geschlossen.
  82.  
  83. --------------------------------------------------------------------------------
  84.  
  85. Die verschiedenen Programm-Versionen:
  86.   Es ist eigentlich sehr einfach: Da  AmigaOS 3.0  einige bessere Funktionen hat
  87. und es  ermöglicht, die  Farben  auf der Workbench zu reservieren, habe ich mich
  88. entschlossen, zwei Versionen  von  MagicEYE  zu erstellen. Eine  für AmigaOS 2.0
  89. (MagicEYE_37) und eine für AmigaOS 3.0 (MagicEYE_39) und höher.
  90.  
  91. --------------------------------------------------------------------------------
  92.  
  93. Wie wird dieses Programm installiert?
  94.   Es  gibt  fast nichts einfacheres als das:  Man muß nur die richtige Programm-
  95. Version in das WBStartup-Verzeichnis der Startdiskette/-festplatte kopieren. Das
  96. wars dann :-]
  97.   Wer die Programme lieber in der User-Startup startet, kopiert die richtige
  98. Programm-Version am besten in sein C-Verzeichnis und ruft MagicEYE in der
  99. User-Startup mit den entsprechenden Parametern auf.
  100.  
  101. --------------------------------------------------------------------------------
  102.  
  103. Verwendung:
  104.   Dieses Programm kann von der Workbench (bzw. WBStartup-Verzeichnis) oder einer
  105. Shell (User-Startup) aus  gestartet werden. Desweiteren  fehlt dem Programm eine
  106. grafische  Oberfäche. D.h. alle Parameter müssen dem  Programm mittels ToolTypes
  107. im Icon bzw. als Parameter übergeben werden. Folgende Parameter sind möglich:
  108. vorhanden:
  109.  
  110.   DONOTWAIT       : Dies ist  eigentlich kein  Parameter  für MagicEYE,  sondern
  111.                     viel mehr ein  Schalter  für die  Workbench.  Dieser Eintrag
  112.                     sollte nicht entfernt werden!
  113.   WIN_X           : Mit diesen beiden Parametern wird die Position der Augen auf
  114.   WIN_Y             dem Bildschirm  festgelegt. Dabei wird von der oberen linken
  115.                     Ecke aus positioniert! Die voreingestellten Werte sind:
  116.                     WIN_X=545  und WIN_Y=1
  117.                     ACHTUNG: Wenn  ein kleiner  Zeichensatz als Titelleistenfont
  118.                     eingestellt  ist (mindestens  11  Punkte), dann  sollte  man
  119.                     WIN_Y auf 0 setzen!
  120.   PRIORITY        : Gibt die Taskpriorität für das System an. Dieser Wert sollte
  121.                     möglichst  unter 0 liegen, damit  Programm,  die  Rechenzeit
  122.                     benötigen diese auch  erhalten. Im  Programm voreingestellte
  123.                     ist der Wert 0, im Icon ist -5 voreingestellt.
  124.   DRAGPATCH       : Mit diesem (NICHT(!)  systemkonformen) Patch ist es möglich,
  125.                     daß man auch mit dem Augen-Fenster den Bildschirm nach unten
  126.                     bzw. zur Seite verschieben kann. Wird dieses Flag angegeben,
  127.                     so ist der  Patch aktiv,  ansonsten wird  dieser Patch nicht
  128.                     durchgeführt.
  129.   BACKGROUND      : Kopiert den Hintergrund der an der  Position ist, an der die
  130.                     Augen erscheinen sollen, in das MagicEYE-Fenster.
  131.   QUICKQUIT       : Schnelles Beenden  von MagicEYE  (mit der rechten Maustaste)
  132.                     ermöglichen.
  133.   BACKDROP        : Mit diesem  Schalter wird der Layer-Patch aktiviert, der das
  134.                     MagicEYE  Fenster  immer  hinter  alle  andere Fenster legt.
  135.                     ACHTUNG: Es wird die  layer.library's Funktion  BehindeLayer
  136.                     (-54) verändert!
  137.   SLEEP_PERIOD    : Dieser Parameter gibt an, wie lange es dauert, bis die Augen
  138.                     geschlossen  werden, wenn  die  Maus nicht mehr bewegt wird.
  139.                     Voreingestellt ist ein Wert von 50. (Einfach mal probieren)
  140.   FRESHUP_PER_SEC : Dieser  Wert gibt an, wie oft  in der  Sekunde die Augen neu
  141.                     gezeichnet, und  damit,  wie oft die Pupillen an  die  Maus-
  142.                     position  angepasst werden  soll. D.h. wenn hier 1 angegeben
  143.                     wird, dann  bedeutet  dies, das  MagicEYE einmal pro Sekunde
  144.                     die Augen an  die  aktuelle  Mausposition  anpasst. Als Vor-
  145.                     einstellung wurde 50  gewählt  (=> 50mal pro Sekunde). Werte
  146.                     größer als 100  sind nicht  sinnvoll  (oder hat jemand einen
  147.                     Workbench-Screen  mit  mehr als 100Hz?) und damit auch nicht
  148.                     möglich. Dieser Wert sollte  möglichst gut überdacht werden,
  149.                     da  er vorallem  auch  die von MagicEYE benötigte Systemzeit
  150.                     angibt  (Je größer  der  Wert,  desto  häufiger  werden  von
  151.                     MagicEYE die Augen neu berechnet und gezeichnet).
  152.  
  153. Und nun zu den 'etwas' interessanteren Effekte-Parametern. Dabei ist anzumerken,
  154. daß die angegebenen Werte die  Wahrscheinlichkeit des  Eintretens dieser Effekte
  155. angibt (1/wert). Es sind nur Werte größer als 1 erlaubt:
  156.  
  157.   SLEEPY          : Mit  diesem Parameter kann  man bestimmen, wie oft die Augen
  158.                     blinzeln  sollen.
  159.   TIRED           : Dieser  Parameter  bestimmt,  wie oft  die  Augenlider  halb
  160.                     herunter klappen.
  161.   ROLL_SYNCHRON   : Bestimmt wie Wahrscheinlichkeit, das  die Pupillen der Augen
  162.                     (synchron, d.h. gleiche Richtung) rollen.
  163.   ROLL_ASYNCHRON  : Bestimmt die Wahrscheinlichkeit, das  die Pupillen der Augen
  164.                     (asynchron, d.h. entgegengesetzte Richtung) rollen.
  165.   LEFTRIGHT       : Wie oft sollen die Augen Links-Rechts schauen?
  166.   RANDOM_EYE      : Gibt an, wie oft die Augen zittern.
  167.   BLOODY          : Bestimmt, wann die Augen rot unterlaufen.
  168.  
  169.   So, daß wäre  eigentlich alles, was man zu diesem Tool wissen müsste. Oder...?
  170. Ach, ich hab noch nicht erzählt, wie man das Programm  beendet? Nun,  eigentlich
  171. meine  ich,  daß dieses Programm auf jede 8 Farben Workbench  gehört. Wenn  aber
  172. jemand dieses Programm  beenden will, dann kann er dies wiefolgt machen (es gibt
  173. zwei Möglichkeiten):
  174. 1.) MagicEYE einfach nochmal starten!
  175. 2.) Exchange starten, MagicEYE aus der Liste auswählen und "Entfernen" anwählen!
  176. 3.) (mit QUICKQUIT) MagicEYE Fenster aktivieren und die rechte Maustaste drücken
  177.  
  178. --------------------------------------------------------------------------------
  179.  
  180. Was kann man an dem Programm noch verbessern?
  181.   * Man kann noch ein paar Spielereien  mit den Augen machen.
  182.   * Man kann noch Augenbrauen einfügen
  183.   * Man kann davon  ausgehen,  das  noch  irgendwelche  Fehler  (undokumentierte
  184.     Möglichkeiten oder gar Käfer ;^) ) enthalten sind, die man entfernen sollte.
  185.  
  186. --------------------------------------------------------------------------------
  187.  
  188. Wer Verbesserungsvorschläge,  Fehler usw. hat, der  kann sollte sich an folgende
  189. Adresse wenden:
  190.  
  191.                  sMail:           Christian Krapp
  192.                                   Hagenmähderstr. 9
  193.                                 D-86391 Stadtbergen
  194.                                   (GERMANY)
  195.                  eMail:           krabbe@informatik.fh-augsburg.de
  196.  
  197. --------------------------------------------------------------------------------
  198.  
  199. Geschichtliches: (xx steht entweder für 37 (AmigaOS 2.04) bzw. 39 (AmigaOS 3.0))
  200.  
  201. Vxx.0   28.04.1995 - Die ersten Arbeiten an dem Programm beginnen (Animationen).
  202. Vxx.1   16.06.1995 - Nach langer Arbeit (und erneutem erstellen der Animationen)
  203.                      ist die erste brauchbare Version fertig.
  204. Vxx.2   01.08.1995 - Ein etwas komischer  Fehler wurde behoben  (Danke an Roland
  205.                      Fulde).
  206.                    - Farbanpassung  implementiert  (Nachdem sich Markus Speicher
  207.                      und Mario  Cattaneo  als  einzige dafür interessiert haben,
  208.                      nur 39.x-Version).
  209.                    - ScreenNotify-Library   wird  unterstützt  (Idee  von  Mario
  210.                      Cattaneo).
  211.                    - Augenrollen (Idee von Dirk Wrocklage).
  212.                    - Zitternde  und rot  unterlaufene  Augen (Idee  von  Michael
  213.                      Krapp).
  214.                    - Augenrollen Asynchron, müde  Augen und Links-Rechts schauen
  215.                      (Idee von Christian Krapp)
  216. Vxx.3   01.03.1996 - ScreenNotify-Library ist nun optional!
  217.                    - Commodity-Library wird vollständig unterstützt!
  218.                    - Jetzt aus Shell oder User-Startup aus startbar.
  219.                    - Rot unterlaufene Augen werden wieder weiß (wenn Augen lang-
  220.                      genug geschlossen).
  221.                    - MagicEYE  hat jetzt  ein besseres  Zeitverhalten. Die alten
  222.                      Versionen liefen nicht korrekt mit Nemac IV (hoher Zeitver-
  223.                      brauch).
  224. Vxx.4   20.02.1997 - Hintergrund kann nun durchscheinend sein (option)!
  225.                    - Quickquit ist wieder als option drinnen!
  226.                    - MagicEYE-Fenster ist immer das hinterste Fenster
  227.                    - MagicEYE im WWW http://www.fh-augsburg.de/~krabbe/magiceye/
  228. --------------------------------------------------------------------------------
  229.